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MEDEX  DOCUMENTATION 


INTRODUCTION 

This  volume  contains  the  information  necessary  to  understand  and 
operate  the  computer  programs  supplied  with  the  MEDEX  PROCESSOR.  The 
documentation  is  organized  into  three  parts.  The  first  provides  a 
description  of  each  of  six  processing  options  open  to  the  user: 

1.  Automatic  Calibration 

2.  Beamforming 

3.  Editing 

4.  Output  of  Selected  Tables  to  Paper  Tape 

5.  Output  of  the  Programs  to  Paper  Tape 

6.  Output  of  uhe  Master  Accumulator  Table  to  Paper  Tape 

The  first  two  options  are  of  a more  analytical  nature  and  as  such 
are  discussed  in  greater  length  than  the  more  adml si  strati ve  routines  (3-6). 

The  documentation  for  Individual  processing  options  generally  follows 
the  outline: 

1.  Introduction  - A brief  description  of  what  the  routine  is  intended 
to  do 

2.  Calling  Sequence  - How  the  routine  is  entered  and  from  where 

3.  Description  of  Input 

4.  Description  of  Output 

5.  Errors  and  Restrictions 

6.  User  Instructions 

7.  Description  of  Processing — keyed  to  a generalized  flow  diagram 
of  the  routine 
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The  second  part  of  the  documentation  Is  a set  of  detailed  flow 
diagrams  of  the  more  analytical  programs  and  subroutines.  The  more 
administrative  type  routines  are  basically  I/O  type  routines  with  little, 
if  any,  of  the  mathematical  foundation  inherent  in  calibration  cr  beam- 
forming.  Consequently,  diagrams  for  these,  beyond  the  generalized 
level  (already  provided),  are  superfluous.  This  part  of  the  documen- 
tation is  contained  in  an  Appendix. 

The  final  part  of  the  documentation  is  a complete  set  of  profusely 
annotated  listings,  separately  bound  and  provide  with  program  titled 
index  tabs. 
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EXECUTIVE  ROUTINE 


INTRODUCTION 

The  executive  routine  simply  allows  the  user  to  select  the  type  of 
processing  he  wishes  to  accomplish  next.  The  user  can: 

1.  Perform  automatic  calibration 

2.  Perform  beamforming 

3.  Edit  certain  operational  parameters  and  shading  coefficients 
as  well  as  display  any  or  ail  of  the  calibration  tables 

4.  Output  tables  to  paper  tape 

5.  Output  programs  to  paper  tape 

6.  Output  master  accumulator  table  to  paper  tape. 

CALLING  SEQUENCE 

The  executive  is  automatically  entered  when  the  system  is  first 
loaded.  It  is  reentered  each  time  any  of  the  six  $ ibroutines  has  been 
completed.  The  user  can  then  select  another  (or  the  same)  processing 
mode. 

DESCRIPTION  OF  INPUT 

The  only  input  the  user  enters  is  the  numerical  choice  of  analysis 
type  (1  to  6). 


DESCRIPTION  OF  OUTPUT 


The  only  display  from  the  routine  appears  as  follows: 

INDEX 

SELECT  ANALYSIS  TYPE: 

1 . BEAMSTEER 

2.  AUTOMATIC  CALIBRATION 

3.  EDIT 

4.  PUNCH  TABLES 

5.  PUNCH  PROGRAM 

6.  PUNCH  MASTER  ACCUMULATOR  TABLE  CHOICE  = 

ERRORS  AND  RESTRICTIONS 

If  the  user  enters  an  invalid  choice,  the  display  responds  with: 

NOT  VALID,  CHOICE  = 

USER  INSTRUCTIONS 

The  selection  list  automatically  appears  on  the  display  after  the 
entire  system  has  been  loaded  or  if  one  of  the  six  subroutines  has  returned 
control.  The  user  simply  enters  one  number  corresponding  to  his  choice 
of  processing. 

DESCRIPTION  OF  PROCESSING 

The  following  flow  diagram  is  self-explanatory. 


71fur«  | s £X£LUT|V£  fm  l of [ 
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CALIBRATION  ROUTINE 


INTRODUCTION 

The  calibration  routine  allows  a calibration  frequency  to  be  entered 
into  every  channel.  All  channels  are  then  simultaneously  sampled  and  the 
resulting  calculated  amplitude  and  phase  data  is  both  displayed  (and, 
consequently,  made  available  for  herd  copy)  and  stored  In  internal  files 
to  be  used  In  subsequent  beamforming  analyses. 

This  routine  is  also  used  in  dockside  checkout  to  verify  that  all 
system  interconnections  are  proper  and  give  expected  amplitude  response, 
phase  response  linearity,  and  noise  measurements  for  the  entire  system 
signal  path,  extending  from  the  preamplifiers  to  the  CRT  display. 

Also,  the  routine  is  used  to  allow  proper  phasing  and  amplitude 
control  to  be  verified  for  the  actual  array  signal  path. 

CALLING  SEQUENCE 

The  routine  is  executed  by  simply  typing  a "2“  when  the  EXECUTIVE 
calls  for  the  next  type  of  analysis.  However,  all  tables  and  parameters 
required  for  calibration  (enumerated  below)  must  have  been  appropriately 
Initialized  prior  to  execution.  This  initialization  is  accomplished  with 

the  Edit  routine. 

DESCRIPTION  Of  INPUT 

The  user  is  requested  to  enter  a set  of  control  and  analysis 
variables  via  the  display.  Each  request  is  made  individually.  For  example, 
"SELECT  ARRAY  TYPE  (1,  2 or  3)  AR  ="  is  displayed  when  the  array  type  Is 
to  be  entered.  Following  th's  request  will  appear  the  last  value  that 
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was  entered  for  this  request.*  If  the  user  wants  to  retain  this  value,  he 
simply  hits  a carriage  return.  However,  if  he  wants  to  change  the  value,  he 
enters  the  new  value  and  this  hits  a carriage  return. 

The  following  is  the  list  of  user  entered  data  and  structure: 

Initial 

Input  Data  Format-  Neumonic  Default  Value  Comments 


1 . Array  Type 

I 

TYP 

1 

The  index  of  the  table  in 

which  calibration  data  will  be 

stored  based  on  array 

type  (1,  2,  or  3). 

2.  Table  ho. 

I 

IFTAB 

1 

1,  2,  3:  the  second  level 

index  for  the  calibration 

table 

3.  Reference 
Hydrophone 
(or  channel) 

I 

IRC 

1.0 

4.  Frequency 

F 

FREQ 

5.  Bandwidth 

F 

6U 

FREQ/BW  must  be  an  integer. 


*When  the  current  execution  Is  the  first  time  through  the  calibration  routinev 
default  values  are  displayed. 
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DESCRIPTION  OF  OUTPUT 


A calibration  table  is  displayed  giving  both  absolute  and  normalized 
amplitudes  and  phases  for  each  channel  . The  table  also 

displays  user  entered  data.  Amplitudes  are  in  dBv  and  phase  is  in  degrees. 
A sample  calibration  table  summary  is  shown  in  Figure  2. 

The  primary  result  of  the  calibration  routine  is  a calibration  table. 
This  table  is  keyed  by  the  array  type  (TYP)  and  the  table  number  (IFTAB). 

A total  of  nine  tables  can  be  generated.  Each  table  is  128  words  long. 

The  table  contains  the  complex  reciprocal  of  the  rectangular  representation 
of  the  normalized,  unskew  corrected  DFT  analysis  coefficients.  Each  pair 
of  64  coefficients  are  stored  in  alternating  sequence.  The  first  (and  all 
subsequent  odd  numbered  elements  up  to  127)  corresponds  to  an  X coordinate 
and  the  second  (and  all  subsequent  even  numbered  elements  up  to  128) 
corresponds  to  a Y coordinate. (All  vectors  having  this  structure  are  said 
to  have  the  "alternating  form.'')  Note  that  the  internally  stored  cali- 
bration table  differs  from  the  displayed  "normalized”  array  in  that  the 
calibration  table  is  the  unskew  corrected,  complex  reciprocal  of  the 
"normalized"  array. 

ERRORS  AND  RESTRICTIONS 

When  the  user  enters  a value  which  is  out  of  the  acceptable  range, 
the  request  for  the  data  is  repeated.  That  is,  an  error  is  indicated  by 
a repeated  question. 

USER  INSTRUCTIONS 

To  enter  the  calibration  routine  from  the  executive,  simply  type 
"2"  and  a carriage  return.  The  user  then  answers  the  questions.  The 
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range  of  acceptable  values  is  displayed  along  with  the  request.  Array  type* 
table  number,  and  reference  hydrophone  all  must  be  entered  without  a deci- 
mal point.  Each  entered  value  must  be  followed  by  a carriage  return.  (Key- 
ing errors  can  be  corrected  by  hitting  the  DELETE  key  if  a carriage  return 
has  not  been  made.)  The  last  value  entered  is  displayed  and  the  user  has 
the  option  to:  (1)  simply  hit  a carriage  return  if  the  value  need  not  change 
for  the  current  calibration  table,  or  (2)  enter  a new  value. 

After  the  a ibration  table  has  been  displayed,  the  user  can  make  a 
hard  copy  by  manually  activating  the  hard  copy  device. 

The  user  must  then  release  the  display  by  typing  an  "R."  The  cali- 
bration routine  is  then  completed.  The  user  is  then  given  the  opportunity 
to  generate  another  calibration  table  or  return  to  the  executive. 

DESCRIPTION  OF  PROCESSING 

Refer  to  the  Generalized  Flow  Diagram. 

1.  Enter  calibration  parameters. 

2.  Compute  and  store  DR  coefficients  (Subroutine  DRCI). 

3.  Compute  and  store  DFT  analysis  output  coefficients  (Subroutine 
DFTD).  This  subroutine  provides  the  software  interface  to  the 
hardware  input  raw  data. 

4.  Use  complex  division  to  normalize  the  output  of  the  DRD  sub- 
routine to  the  selected  reference  charnel. 

5.  Create  the  skew  correction  table  as  a function  of  frequency  and 
sampling  rate  (Subroutine  SKEW). 
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6.  Calculate  skew  corrected  absolute  DFT  output  coefficients  by  performing 
a complex  multiplication  (using  Subroutine  MATX)  between  the  output 

of  the  DFTD  routine  and  the  skew  correction  table. 

7.  Calculate  the  skew  corrected  normalized  DFT  output  coefficients  by 
performing  a complex  multiplication  between  the  normalized  DFT  results 
(from  (4))  and  the  skew  correction  table. 

8.  Print  calibration  table  of  absolute  and  normalized  skew  corrected 
DFT  results  ir  dB  for  amplitude  and  degrees  for  phase. 

9.  Calculate  and  store  the  actual  calibration  table  by  taking  the  complex 
reciprocal  of  the  normalized,  but  unskew  corrected  DFT  coefficients 
previously  calculated  under  (4). 

10.  Store  the  frequency  and  bandwidth  used  for  generation  the  current 
calibration  table. 
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BEAMF0RMIN6  ROUTINE 


INTRODUCTION 

Beamforming  is  done  by  using  real-time,  digital  phasing  techniques. 

In  the  computer,  one  beam  sample  is  calculated  from: 

D = I Ai  x 8.  x 

wnere 

D = the  beam  sample 

Aj=  the  i-th  signal  amplitude  and  phase  (from  the  OFT  routine) 

B. j=  the  i-th  channel  amplitude  and  phase  correction  factors 

(from  the  calibration  routine) 

C. .=  the  amplitude  and  shading  coefficients  (from  the  STRPH). 

A,  B,  and  C are  all  arrays  of  complex  numbers,  rectangular  form, 
and  elements  in  length.  The  complex  0 will  represent  the  beam 
sample  at  a specific  analysis  frequency  and  a specific  analysis  band- 
width. Results  are  ultimately  displayed  both  in  tabular  and  graphical  form. 

CALLING  SEQUENCE 

The  routine  is  executed  by  simply  typing  a “1M  when  the  EXECUTIVE 
calls  for  the  next  procedure.  Execution  of  the  beamforming  routine  assumes 
that  all  required  tables  and  parameters  have  been  appropriately  initialized. 
This  includes  an  appropriate  calibration  table. 

DESCRIPTION  OF  INPUT 

The  user  is  requested  to  »*nter  a set  of  control  and  analysis  variables 
via  the  display,  as  well  as  set  three  sense  switches.  The  sense  switches: 
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(1)  allow  execution  of  the  routine  to  be  delayed  until  a specific  time, 

(2)  allow  bypassing  the  plotting  routine,  and/or  (3)  allow  the  updating  of 
the  master  accumulator  table  (which  is  used  to  runulate  overall  summary  data). 
User  entered  data  is  requested  in  the  $ai«e  manner  as  for  the  calibration  rou- 
tine, namely:  (1)  the  request  for  data  is  made  followed  by  the  current  value 
of  the  input  variable,  (2)  if  the  user  simply  hits  a carriage  return,  the 
current  value  is  unchanged  and  becomes  the  new  value  to  be  used,  and 

(3)  otherwise,  the  user's  entered  value  replaces  the  current  value  after 
a carriage  return  is  typed. 

A list  of  user  entered  data  follows  together  with  the  format  that  is 
expected  (I  = integer,  F = floating  point)  and  the  mnemonic  used  in  the 


program. 


Input  Data 

Format 

Mnemonic 

Comments 

1. 

Array  Type 

I 

TYP 

1 , 2,  or  3 

2. 

Table  Number  of 
Shading  Coefficients 

I 

ISHD 

1 , 2,  or  3 

3. 

Range  of  Steer  Angles 

F 

PHMN, 

PHMX 

The  minimum  and  maximum  steer 
angles  to  be  used  such  that 

-90.0°<_  PHMN<PHMX<90 . 0° 
(90.0°  is  forward  and  0.0° 
is  broadside.) 


4.  Quantity  of  Steer  I 

Angles  to  be  used 

5.  Steer  Angle  Increment  I 

Mode 


NSA 


INMOO  1 = sir.  (o) 

2=o 

Steer  angles  between  PHWi 
and  PHMX  can  be  generated 
based  on  equal  increments 
In  sine  or  simply  equal 
angles. 


F 


6.  Bandwidth 


BUI ,BW 


Input  Data  Format 

Mnemonic 

Comments 

7.  Quantity  of  frequen- 
cies to  be  generated 

I 

fIF 

1<NF<8 

8.  Input  Frequency  Mode 

I 

MDFRQ 

Indiscrete 

2=$wept 

3=retain 

This  gives  the  user  the 
option  of:  (1)  entering  NF 
specific  frequencies, 

(2)  creating  NF  frequencies, 
each  separated  by  one  band- 
width, or  (3)  retaining  the 
previous  set  of  frequencies. 

9.  (Only  if  MDFRQ=1 ) 
Frequencies 

F 

FRQ(*) 

The  set  of  NF  discrete 
frequencies 

10.  (Only  if  MDFRQ=1) 
Vector  of  calibration 
table  to  be  used 

I 

CALDX(*) 

The  set  of  NF  indices  to  the 
calibration  tables.  Each 
element  can  be  1,  2,  or  3. 
(Note  that  CALDX(I)  will  be 
used  in  conjunction  with 
FRQ(I)  only). 

11.  (Only  if  MDFRQ-2) 
First  frequency  in 
sequence 

F 

FRQ(l) 

One  frequency  only;  the  range 
of  possible  values  will  be 
displayed  with  the  request 
since  the  maximum  is  a function 
of  BW. 

12.  (Only  if  MDFRQ=2) 
Calibration  table 
number 

I 

CALDX(l) 

One  number , 1 , 2 , or  3 to  be 
used  for  all  frequencies  in 
the  sweep. 

13.  Averaging  Mode 

I 

AM00 

1=simple  averaging 
2=exponential  averaging 

14.  (Only  if  AMOD=2) 

Exponential  Averaging 
Time 

F 

TAU 

.2<TAU<106 

15.  No.  of  samples  per  plot 
(i.e.,  the  sample  size) 

I 

NS 

— 

16.  No.  of  group  of  NF 
frequencies  to  be 
plotted 

I 

NG 

Such  that  1<NG-NF<_3?  .The  num- 
ber of  sets  of  NF  frequencies 
to  be  displayed  on  the  graph. 
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DESCRIPTION  OF  OUTPUT 

The  primary  outputs  of  the  beamforming  routine  are: 

1.  Graphs  (amplitude  versus  steer  angle) 

2.  Plot  Data  Table 

3.  Master  Accumulator  Table 

The  first  two  are  summaries  of  the  current  run  whereas  the  master 
accumulator  table  summarizes  data  over  a series  of  selected  runs. 

Graphs 

The  header  of  each  graph  contains  the  following  supportive  information: 

1.  The  array  type 

2.  The  type  of  filtering  used 

3.  The  index  number  of  the  shading  coefficients  table  used 

4.  A sequential  list  of  calibration  tables  used  for  the  respective 
frequencies 

5.  The  number  of  samples  for  each  frequency 

6.  The  exponential  averaging  time 

7.  The  bandwiJth  in  Hz 

8.  The  date 

9.  The  time  the  current  run  was  initiated 

10.  A scale  factor  that  should  be  used  to  translate  OB-V  (e.g.) 

OB-uV.  This  scale  factor  is  input  via  the  EDIT  routine  and 
plays  no  part  whatsoever  in  any  of  the  computations.  It  is  simply 
an  annotating  device. 

Figure  4 shows  a sample  graph  with  all  but  the  first  axes  removed. 

To  the  right  of  each  plot  is  its  respective  frequency  in  hertz. 
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Plot  Data  Table 


The  Plot  Data  Table  is  the  tabular  results  of  what  was  displayed  on 
the  graph.  It  displays  the  amplitude  (in  D8-V)  for  each  of  the  selected 
steer  angles  over  each  of  the  selected  frequencies.  See  Figures. 


The  header  contains  the  following  information: 

1 . The  date 

2 . The  time 

3.  The  number  of  updates  (does  not  apply  for  this  tables  see  below) 

4.  The  scale  factor  (see  explanation  under  Graph) 

*>.  The  filtering  type 

6.  The  array  type 

7.  The  shadinq  coefficient  table  number 

8.  The  list  of  calibration  tables  with  respect  to  frequencies 

9.  The  sample  size 

10.  The  exponential  averaging  time 
.11.  The  bandwidth 


Master  Accumulator  Table 

This  table  has  the  same  basic  structure  as  the  plot  data  table.  The 
only  difference  being  the  title  and  the  parameter  indicating  the  number  of 
times  this  table  has  been  updated  since  last  cleared.  See  Figure  6. 

USER  INSTRUCTIONS 

The  beamforoing  routine  is  entered  by  typing  "1 ' when  in  the  EXECUTIVE. 
The  user  should  then  set  sense  switches  if  he  wants  to  delay  execution 
or  eliminate  the  plots  or  bypass  updating  the  master  accumulator  table. 

The  user  then  answers  the  questions  displayed. 
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The  first  question  gives  the  user  an  opportunity  to  rerun  the  routine 
using  the  old  input  parameters.  Typing  an  "N"  to  the  question,  "NEW  INPUT 
PARAMETERS,"  will  bypass  all  of  the  questions  and  go  directly  to  execution. 
A "Y"  will  start  the  display  of  input  questions. 

The  range  of  acceptable  values  is  displayed  along  with  each  request. 
Each  entered  value  must  be  followed  by  a carriage  return.  (Keying  errors 
can  be  corrected  by  using  the  DELETE  key  if  a carriage  return  has  not  been 
made.)  The  last  value  entered  (i.e.,  from  the  previous  run)  is  also  dis- 
played, and  the  user  has  the  option  to  hit  a carriage  return  if  the  value 
need  not  change  for  the  current  run  or  enter  a new  value.  A sample  of  the 
question  set  is  shown  in  Figure  7.  The  questions  themselves  are  self- 
explanatory.  The  last  question  gives  the  user  a chance  to  escape  back  to 
the  start  of  the  question  set  if  he  has  made  a mistake  before  actual 
execution  is  started.  Typing  a carriage  return  indicates  an  acceptance 
of  all  answers  to  the  questions  and  actual  execution  is  then  started. 

If,  however,  sense  switch  "0"  has  been  set  (indicating  that  the  user 
wants  to  delay  the  run  until  a specific  time),  the  user  is  asked  to  enter 
the  time  at  which  he  would  like  execution  to  commence.  He  should  enter 
the  time  as  shown  in  the  following  example  (with  colons). 

14:23:30 

Follow  this  with  a carriage  return  (as  usual).  Execution  will  then  start 
exactly  when  the  system  clock  reaches  the  input  start  time. 

After  all  plots  have  been  completed,  the  user  can  make  a hard  copy  of 
the  display  if  he  wishes.  Then,  typing  an  "R"  releases  the  screen  and  the 
plot  data  table  is  displayed.  If  the  user  requested  more  than  33  steer 
angles,  a second  page  will  be  displayed  when  the  first  has  been  released. 
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ENTER  TOTAL  NUMBER  OF  SAMPLES  PER  PLOT 

DOES  THE  USER  WISH  TO  CLEAR  THE  MASTER  ACCUMULATION  TABLE  (Y  OR  N) 
ENTER  NO.  GROUPS  OF  1 FREQ.  TO  PLOT  (1-32)  1 

RETURN  TO  GO,  ANYTHING  ELSE  REPEATS  QUESTIONS 
INPUT  START  TIME  HR: MIN: SEC 


Unless  the  master  accumulator  has  not  been  updated  (sense  switch  2 has 
been  set),  this  table  is  displayed  after  the  last  page  of  the  plot  data 
table  has  been  released. 

DESCRIPTION  OF  PROCESSING 

Refer  to  the  Generalized  Flow  Diagram  (Figure  8)- 

1.  Enter  and/or  generate  parameters  and  program  control  variables. 

2.  Generate  the  isometric  plot  axis  and  display  input  data. 

3.  Precompute  the  OFT  coefficients  as  a function  of  the  center 
frequency  and  the  analysis  bandwidth  (subroutine  DFTCI). 

4.  Perform' the  OFT  on  one  signal  sample  (subroutine  DFTD). 

5.  Calculate  the  complex  matrix  product  of  the  output  from  DFTD  and 
the  appropriate  calibration  table. 

6.  Precompute  constants  used  in  calculating  the  amplitude  and  phase 
shading  coefficients. 

7.  Calculate  the  amplitude  and  phase  shading  coefficients  and  calcu- 
late one  beam  sample  using  fixed  point  arithmetic. 

8.  Update  the  plot  data  table  using  either  simple  or  exponential  averaging. 

9.  Plot  one  line  on  the  display.  This  graph  represents  the  average  ampli- 
tude (in  D8)  for  a specific  frequency  over  the  entire  range  of  steer 
angles. 

10.  Update  the  master  accumulator  table,  if  required.  This  table  can  be 
used  to  summarize  data  over  a series  of  runs  of  the  beamformirg  routine. 

11.  Display  the  plot  data  table. 

12.  Display  the  master  accumulator  table  if  updated. 
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EDIT  ROUTINE 


INTRODUCTION 

The  EDIT  routine  is  used  to  perform  any  of  the  following  functions: 

1.  Change  the  date  that  is  displayed  on  all  tabular  summaries  and 
graphs . 

2.  Change  any  or  all  elements  of  the  amplitude  shading  coefficients 
table. 

3.  Change  any  of  the  basic  plot  format  items  (e.g.,  width  or  height 
of  a plot,  distance  between  successive  plots,  etc.). 

4.  Display  any  internally  stored  calibration  table. 

C.  Change  any  of  the  values  of  array  spacing. 

6.  Change  the  velocity  of  sound  parameter. 

7.  .'elect  any  of  three  methods  of  DFT  analysis:  (1)  Conventional, 

(2)  Hanning,  and  (3)  Wag 

CALLING  SEQUENCE 

The  EDIT  routine  's  only  called  from  the  EXECUTIVE  routine  by  typing 
a “3."  Editing  is  usually  one  of  the  first  activities  the  user  will  per- 
form in  setting  up  subsequent  analyses. 

DESCRIPTION  OFJMPUT 

All  input  data  is  entered  via  the  display.  As  before,  the  user  Is 
presented  a series  of  questions  or  options.  His  answers  and  selections 
determine  what  and  how  data  is  to  be  edited. 

DESCRIPTION  OF  OUTPUT 

When  single  valued  parameters  are  to  be  edited,  their  current  value 
is  displayed.  The  user  can  then  determine  if  he  wishes  to  retain  the 
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current  value  (by  simply  hitting  carriage  return)  or  changing  the  value. 

Tables  subject  to  editing  (exclusively  the  amplitude  shading  coefficient 
tables)  are  displayed  in  their  entirety  before  actual  changes  can  be  made. 
(See  Figure  9.) 

Option  "4U  simply  displays  one  entire  calibration  table  as  it  is 
stored  internally.  No  alteration  of  the  table  can  be  made  with  the  EDIT 
routine.  (Such  alterations  must  be  performed  by  rerunning  the  AUTOMATIC 
CALIBRATION  routine.)  An  example  is  shown  in  Figure  10. 

USER  INSTRUCTIONS 

The  user  enters  the  EDIT  routine  by  typing  a "3."  The  following  is 
then  displayed: 

EDIT  OPTIONS 

1 . DATE 

2.  AMP l 

3.  PLOT  FORMAT 

4.  PRINT  CALTB 

5.  SPACING 

6.  C EDIT 

7.  OFT  EDIT 
CHOICE  » 
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The  user  makes  his  choice  by  entering  the  selected  index  number. 
Following  is  a description  of  each  of  the  options: 

1.  DATE 

Ontion  1 responds  by  displaying  the  entire  date  (e.g.,  30  NOV  74). 
Then  day,  month,  and  year  are  displayed  respectively,  and, 
after  each,  the  user  must  either  retain  the  current  value  (which 
has  also  been  displayed)  by  hitting  return,  or  he  must  change 
the  value.  Months  are  entered  as  integers  1 to  12,  and  the  year 
is  represented  by  only  the  last  two  digits,  i.e.,  74. 

2 . AMPLITUDE  SHADING  COEFFICIENTS  TABLE 

Option  2 responds  by  asking  which  of  the  three  possible  amplitude 
shading  coefficients  tables  the  user  wishes  to  edit.  The  selected 
table  is  then  displayed  (e.g.,  see  Figure  9).  The  user  is  then 
given  the  option  to  edit  a specific  element  or  set  all  elements 
to  a constant.  If  the  latter  is  chosen,  the  user  must  enter  the 
specific  constant  to  which  all  elements  are  to  be  set.  After  all 
elements  have  been  assigned,  processing  continues  in  the  single 
element  edit  mode. 

Single  elements  in  a table  are  edited  by  selecting  the  element 
number  (1  to  64)  and  then  entering  a value.  (As  always,  a numeri- 
cal response  must  be  followed  by  a carriage  return.)  Typing  of 
just  a return  after  "ELEMENT  NO.  ="  appears,  escapes  editing  of 
this  table.  The  user  may  then  either  continue  editing  another 
shading  coefficients  table  or  return  to  the  edit  options  list. 
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3.  PLOT  fORMATS 


Option  3 allows  the  user  to  alter  the  dimensions  of  the  plots. 

The  following  nine  parameters  are  displayed  and  edited,  one  by  one. 


DZX  - The  X-distance  (in  plot  points*)  from  absolute  "0"  (on 
the  screen)  to  "0"  on  the  first  plot  axis. 

DZY  - The  Y distance  (in  plot  points)  from  absolute  "0"  (on 

the  screen)  to  the  origin  of  the  first  axis. 

IWD  - The  width  of  one  plot  axis  (in  plot  points). 

IHI  - The  height  of  one  plot  axis  (in  plot  points). 

DX  - The  X distance  (in  plot  points)  from  one  plot  origin  to 

the  next. 

DY  - The  Y distance  from  one  plot  origin  to  the  next. 

LSW  - The  light  switch,  "0"  removes  all  plot  axes  but  the  first; 
"1"  includes  all  axes  on  the  plot. 

YMIN  - The  lowest  value  (in  DB)  to  be  displayed  on  the  vertical 
scale. 

SCF  - The  range  (in  DB)  of  the  vertical  scaling  (note  that  the 
highest  scaling  number  on  the  vertical  axis  is  SCF  - YMIN). 
Actual  data  plots  will  be  truncated  below  YMIN,  but  will  not  be 
truncated  ’bove  (SCF-YMIN),  the  highest  scale  value. 


*There  are  approximately  100  points  per  inch  vertically  and  115  points  per 
inch  horizontally. 
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4.  PRINT  CALIBRATION  TABLE 


Option  4 simply  asks  the  user  to  select  a specific  table  and  then 
displays  it.  The  user  can,  at  this  point,  make  a hard  copy  if 
he  so  desires.  A return  to  the  edit  option  list  is  accomplished 
by  typing  an  "R"  to  release  the  screen. 

5.  SPACING 

Option  5 allows  the  user  to  enter  the  array  spacing  (in  feet)  for 
each  of  three  array  types.  The  first  spacing  parameter  will  be 
used  when  array  type  one  has  been  called  for.  Similarly  for 
array  types  two  and  three.  Each  respective  spacing  parameter  is 
displayed  as  it  currently  is  stored  and  the  user  can  enter  a new 
value  or  retain  the  old.  A carriage  return  after  editing  the 
third  spacing  parameter  returns  to  the  edit  option  list. 

6.  VELOCITY  OF  SOUND  (C). 

Option  6 allows  the  user  to  edit  this  single  valued  parameter 
expressed  in  feet  per  second. 

7.  OFT  EDIT 

Option  7 allows  the  user  to  select  the  type  of  filtering  he  wishes 
to  employ;  1 is  a straight  DR  (rectangular  window);  2 employs 
a Hanning  window;  and  3 uses  a Wag  window.  After  making  the 
selection,  the  user  is  requested  to  enter  a DR  scale  factor. 

This  simply  is  a constant  that  is  used  to  annotate  every  output. 

It  does  not  affect  plotted  or  tabulated  outputs  in  any  way. 


When  the  user  has  finished  editing,  he  can  return  to  the  EXECUTIVE 
by  typing  a carriage  return  whenever  a choice  is  to  be  made  from  the  edit 
option  list. 
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DESCRIPTION  OF  PROCESSING 

The  processing  is  relatively  simple  since  it  basically  involves  the 
following  steps  (for  all  but  Option  4): 

1.  Select  data  to  edit. 

2.  Display  current  value  or  values. 

3.  Change  or  retain  current  value. 

4.  Continue  edit  or  return  to  executive. 

The  following  flow  diagrams  are  self  explanatory. 
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PUNCH  TABLES  ROUTINE 


INTRODUCTION 

This  routine  allows  the  user  to  store  the  calibration  tables  on  paper 
tape.  In  addition  to  the  calibration  table,  the  routine  punches  the  ampl1“ 
tude  shading  coefficients  and  a table  containing  header  information  for 
each  of  the  calibration  tables. 

CONSTRAINTS 

This  routine  punches  only  a specific  section  of  core,  specifically, 
that  section  containing: 

1.  The  calibration  tables 

2.  The  amplitude  shading  coefficients 

3.  The  header  table. 

4.  The  Spacing  Table 

CALLING  SEQUENCE 

This  routine  is  called  as  one  of  the  options  of  the  EXECUTIVE  routine. 
The  program  Is  usually  executed  following  generation  of  the  calibration 
tables,  thereby  allowing  the  subsequent  use  of  the  calibration  tables 
without  requiring  their  regeneration  via  execution  of  AUTOMATIC  CALIBRATION. 

DESCRIPTION  OF  OUTPUT 

The  sole  output  of  this  routine  is  a paper  tape  containing  2724  words 
of  data  in  binary. 

USER  INSTRUCTION 

This  routine  is  entered  from  the  executive  by  simply  typing  *4"  and 
a carriage  return.  The  user  is  then  reminded  (via  the  display)  to  turn 
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the  paper  tape  punch  on.  The  user  must  then  type  any  key.  This  starts 
the  punching  of  the  tables.  On  completion,  control  is  returned  to  the 
executive  for  further  processing  Instructions. 

DESCRIPTION  OF  PROCESSING 

The  entire  routine  consists  of  a call  to  subroutine  PUNCH.  This 
subroutine  is  passed  the  beginning  address  of  the  first  calibration 
table,  the  last  address  of  the  last  header  table,  and  the  address  to 
which  the  loader  is  to  return  on  completion. 
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PUNCH  PROGRAM 


INTRODUCTION 

This  routine  copies  all  programs  onto  paper  tape.  Internally  stored 
data  is  not  punched  by  this  routine.  (Selected  tables  can  be  punched 
using  the  PUNCH  TABLES  routine.) 

CALLING  SEQUENCE 

The  program  is  only  accessible  from  the  executive  routine.  It  is 
entered  by  typing  a "5." 

DESCRIPTION  OF  OUTPUT 

The  sole  output  of  this  routine  is  a paper  tape  containing  approxi- 
mately 14K  words  of  proyram  in  binary. 

USER  INSTRUCTIONS 

The  routine  is  entered  from  the  executive  by  typing  a "5"  and  a 
carriage  return.  The  user  is  then  reminded  (via  the  display)  to  turn  on 
the  paper  tape  punch  and  then  type  any  character.  This  initiates  the 
punching  of  the  first  of  two  sections  of  core.  The  user  is  notified  (via 
the  display)  when  the  first  section  has  been  completed.  The  user  should, 
at  this  point,  cut  off  this  segment  of  tape  since  keeping  both  sections 
on  one  tape  will  make  the  fan-folded  paper  tape  slightly  unwieldly.  The 
punching  of  the  second  section  Is  started  l>y  typing  any  character.  On 
completion,  control  is  returned  to  the  executive  for  further  processing 
instructions. 
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DESCRIPTION  OF  PROCESSING 

The  entire  routine  consists  of  two  seauential  calls  to  subroutine 
PUNCH.  The  first  call  passes  the  beginning  address  of  the  first  core 
section  of  programs,  its  last  address,  and  the  address  to  which  the 
loader  is  to  return  on  completion.  The  second  call  punches  the  second 
core  section  utilizing  a similar  call. 


49 


PUNCH  MASTER  ACCUMULATOR  TABLE  ROUTINE 


INTRODUCTION 

This  routine  allows  the  user  to  store  the  master  accumulator  table 
on  paper  tape. 

CALLING  SEQUENCE 

This  routine  is  Option  6 of  the  executive  routine.  It  will  be  used 
primarily  to  store  cumulative  results  for  particularly  long  runs.  Subse- 
quent input  of  this  table  allows  the  user  to  start  "where  he  left  off" 
when  reloading  the  system. 

DESCRIPTION  OF  OUTPUT 

The  only  output  of  this  routine  is  a paper  tape  containing  1040 
words  of  data. 

USER  INSTRUCTIONS 

The  routine  is  entered  from  the  executive  by  typing  "6"  and  a 
carriage  return.  The  user  is  then  reminded  (via  the  display)  to  turn  the 
paper  tape  punch  on.  The  user  must  then  type  any  key  to  initiate  punch- 
ing of  the  table.  On  completion,  control  is  returned  to  the  executive 

for  further  processing  instructions. 

DESCRIPTION  OF  PROCESSING 

The  entire  routine  consists  of  a call  to  subroutine  PUNCH.  The  sub- 
routine is  passed  the  beginning  address  of  the  master  accumulator  table, 

its  last  address,  and  the  address  to  which  the  loader  is  to  return  on 

completion. 


5l 


r***mim 


mi 


APPENDIX 


Detailed  flow  diagrams  are  included  for  the  following  analysis 
programs  and  subroutines: 
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